home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / datatypes / picturedt-v43 / readme < prev    next >
Text File  |  1996-07-16  |  10KB  |  304 lines
  1.  
  2.                         picture.datatype V43
  3.                           Copyright 1995-96
  4.                            Ralph Schmidt
  5.            Additional libs/tools/changes by Frank Mariak
  6.            All sub datatypes by Matthias Scheler
  7.  
  8.  
  9. This  version is a freely available picture.datatype that MUST ONLY be used
  10. with  a  licenced  CyberGraphX(TM)  software  package  when using non 8 bit
  11. screenmodes.  You aren't allowed to use this software with any non licenced
  12. CyberGraphX(TM)  "emulation"  in these modes.  You are allowed to use it on
  13. ECS/AGA only machines with the freely available cyberncg.library included.
  14.  
  15.  
  16.  
  17.  
  18. This is a
  19.  
  20. #######  ####### ######### ########
  21. #      # #           #     #      #
  22. #      # #           #     #      #
  23. #######  #####       #     ########
  24. #      # #           #     #      #
  25. #      # #           #     #      #
  26. #######  #######     #     #      #
  27.  
  28. Release
  29.  
  30. This means...not fully done, not fully tested, use it at your own risk.  It
  31. may cause problems...perhaps the world will end after you've installed it.
  32.  
  33. If  you are using it on a non CyberGraphX machine, do not forget to install
  34. cyberncg.library coming with this archive
  35.  
  36. #########################
  37. #                       #
  38. #Important Informations #
  39. #                       #
  40. #########################
  41.  
  42. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  43. IF YOU'RE USING THE APPS THAT ARE IN THE COMPATIBILITY LIST( CHECK OUT SOME
  44. LINES  BELOW)  YOU  HAVE  TO NAME YOUR APPLICATION EXACTLY LIKE IN THE LIST
  45. OTHERWISE WON'T RECOGNIZE IT.
  46. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  47.  
  48. The  Aminet  release  of the png.datatype supports the V43 picture.datatype
  49. but  because  of  a  late change to the API(DTA_ErrorLevel,DTA_ErrorNumber)
  50. these  don't  support  these  tags.   I  hope  that  the authors of these 2
  51. datatype update their datatypes in the next time.
  52.  The  tags  are VERY important in a low memory situation.
  53.  
  54.  A  V43  compatible tiff.datatype as well as an bmp.datatype have also been
  55. released so far.
  56.  
  57.  
  58. Problems
  59.  
  60. o PPaint doesn't load 24bit images. Well..PPaint checks the BMHD.depth of
  61.   the raw data for >8...too bad
  62.  
  63. o Picview outputs "not a standard bitmap or something like that". This
  64.   is caused by the cgfx "PLANESTOFAST" option.
  65.  
  66. The following functions aren't implemented yet.
  67.  
  68. o 24bit dithering to a very small depth planar bitmap may cause
  69.   "problems". No time to test this out.
  70. o Sorry...also no time(lazyness) to test out PixMap support. I hope
  71.   it works as defined.
  72. o Right now it also doesn't really care for Ham6/8 and Halfbright.
  73. o DTM_Print for truecolour pictures should differ the picture to 256 colours
  74.   and then print it.
  75. o Make a Gauge interface so it may be controlled by tags(but does that
  76.   really make sense ? imagine a gauge popping up when iprefs is loading
  77.   your background)
  78. o scrollable transparent picture handling should be improved.
  79.   Now it only switches back in nonmask mode.
  80. o ******* AMosaic crashes ******* in 16Bit mode...i don't know why
  81.   yet(it worked in that mode in summer of 95 ......).
  82.  
  83.  
  84. ############################################################################
  85.  
  86.  
  87.  
  88. Questions&Bugreports
  89. Don't expect fast response.
  90.  
  91. Send bug reports to <cybergfx.dtbugs@vgr.com>
  92.  
  93. Ralfph Schmidt <laire@popmail.owl.de>        picture.datatype
  94. Matthias Scheler <tron@lyssa.owl.de>            ilbm.datatype
  95.                                                 gif.datatype
  96.                                                 jfif.datatype
  97.                         pcx.datatype
  98.                                                 ppm.datatype
  99. PhFrank Mariak <fmariak@phase5.de>             CyberGraphX
  100.                         cyberncg.library
  101.                                                 picture.datatype
  102.  
  103.  
  104. The jfif.datatype is using the "jpeg.codec"
  105.  
  106. The JPEG codec is Copyright © 1994 Christoph Feck, TowerSystems.
  107. All Rights Reserved.  It is based in part on the work of the
  108. Independent JPEG Group.
  109.  
  110. ############################################################################
  111.  
  112.  
  113.  
  114.  
  115. ****************************************************************************
  116.  
  117. ATTENTION:
  118.  
  119. YOU  NEED TO HAVE AT LEAST VERSION 40.66 OF CYBERGRAPHICS.LIBRARY INSTALLED
  120. TO  USE THIS RELEASE OF PICTURE.DATATYPE V43 IN CONJUNCTION WITH A GRAPHICS
  121. CARD !
  122.  
  123. IF YOU INSTALL THIS ARCHIVE ON A DRACO BASED SYSTEM PLEASE MAKE SURE NOT TO
  124. INSTALL THE CYBERGRAPHICS.LIBRARY COMING WITH THIS ARCHIVE !
  125.  
  126. ****************************************************************************
  127.  
  128. Release Notes
  129.  
  130. V43.751
  131.  
  132.  o the public semaphore is now available even if the picture.datatype is
  133.    expunged. This fixes a severe crash when the library is expunged
  134.  
  135. V43.750
  136.  o fixed a BYTE-READ from $0 when non v43 compatible applications called the 
  137.    picture.datatype
  138.  
  139. V43.748
  140.  
  141.  o gtlayout.library included in this archive. (required for the prefs
  142.    program)
  143.  o The application list which contains all V43 compatible applications may
  144.    now be configured with a seperate prefs program.
  145.  o removed support for environment variable "cybergraphics/pcdt_dither"
  146.    Please use the supplied prefs program PCDT to change dither settings now
  147.  o the expiration time is now 4 month instead of 1 month. So users who
  148.    can not access the net but get the datatype from an aminet cd are able
  149.    to use the picture.datatype release  for a certain amount of time
  150.    until a new version is released on cd
  151.  o there is an installer script now for v43 datatype installation which
  152.    also includes a backup option
  153.  o Tower JPEG Codec Class included as seperate archive
  154.  o new gif.datatype sub class V43.12 included
  155.  
  156. V43.718
  157.  
  158.  o bug fix in conjunction with datatype objects which require
  159.    mask planes and use planar bitmaps
  160.  o API-Demo source for datatype to ppm conversion added
  161.  o new versions of sub datatypes included
  162.  
  163. V43.716
  164.  
  165.  o ENV: "cybergraphics/pcdt_dither"
  166.    0 == Floyd Dithering(Better,slower) (DEFAULT)
  167.    1 == Ordered Dithering(Faster,Not so good gfx quality)
  168.  
  169. V43.713
  170.  
  171.  o new cybergraphics.library prerelease included
  172.  o the picture.datatype now uses ordered dithering as default.
  173.    A switch to select between floyd or ordered may follow in the
  174.    future
  175.  o included a new cyberncg.library which fixes a problem with
  176.    transparent images
  177.  o added V43 compatible PCX sub datatype to archive
  178.  
  179. V43.695
  180.  
  181.  o now supports AGA/ECS machines with cyberncg.library included in this archive.
  182.  
  183. V43.684
  184.  
  185.  o some internal structures have changed. Please use the new
  186.    cybergraphics.library coming with this archive
  187.  o the picture.datatype expires after a few weeks now
  188.    (all pre release versions will do that in the future)
  189.  o fixed a problem in conjunction with PDTA_DestBitMap and
  190.    ODF_USEFRIENDBITMAP which caused twice freed BitMaps in
  191.    the past
  192.  
  193. V43.667
  194.  o Fixed a 24bit->8Bit(OldBitmap) Dither problem.
  195.    Was caused by a change of the CyberBitmap checking code.
  196.    This may be the problem some experienced with PPaint which
  197.    i don't have to test it out...
  198.  
  199. V43.658
  200.  o Fixed a MUI Pattern problem
  201.  o Added DTM_DRAW...not tested
  202.  
  203. V43.647
  204.  o Fixed the remap problem some people experienced
  205.  
  206. V43.629
  207.  o Finally fixed the mysterious crash bug.
  208.  
  209. V43.6xx
  210.  o Multiview cludge
  211.  o Smarter Monitor ID overruling
  212.  o Alphachannel support
  213.  o fixed PDTA_DestMode,MODE_V42 fallback..
  214.  o Added an internal V43 compatibility list with the current entries:
  215.     "« IPrefs »",
  216.     "multiview",
  217.     "amigaguide",
  218.     "amosaic",
  219.     "amosaic-as225",
  220.     "amosaic-amitcp",
  221.     "DirectoryOpus",
  222.         NULL
  223.  o Fixed Aspect=0 save problem
  224.  o smarter PDTA_UseFriendBitMap that only does something when needed
  225.  o Truecolour alphachannel mask generation activated...will be used
  226.    automaticly by OM_RENDER
  227.  o 8Bit transparent mask generation activated...will be used automaticly
  228.    by OM_RENDER
  229.  o Fixed V42 fallback mode mungwall problems with dithering..hopefully.
  230.  o OM_Render transparent special handling..see docs for more infos
  231.  o Subdatatype Error API improvement
  232.  o creating transparent mask without layout if needed
  233.  o Fixed long outstanding V42 fallback color problem bug visible with DirOpus and others.
  234.  
  235. V43.451
  236.  o Important!!!!!
  237.    Include Change
  238.    DTM_BLITPIXELARRAY -> DTM_WRITEPIXELARRAY
  239.  
  240.  o PDTA_DEST works now. This means if PDTA_DEST,MODE_V43 isn't set
  241.    by application programs, a slow old planar bitmap is returned to
  242.    not break old programs that can only handle that bitmap.
  243.    Sigh..i could add an application list that works bitmaps format
  244.    independent.
  245.    Only exception is IPrefs for now...it gets a chunky bitmap.
  246.  
  247.  o PDTA_UseFriendBitMap is implemented(Stuntzi)
  248.  
  249.  o PDTA_NumPixMapDir
  250.    DTM_CREATEPIXMAPDIR
  251.    DTM_FIRSTPIXMAPDIR
  252.    DTM_NEXTPIXMAPDIR
  253.    DTM_PREVPIXMAPDIR
  254.    DTM_BESTPIXMAPDIR
  255.  
  256.    added to support multi-volume gfx formats like TIFF.
  257.  
  258.  o DTM_READPIXELARRAY added to avoid the sub datatype data sharing
  259.    design problem of the picture.datatype. If you ask me i would
  260.    have disallowed any data sharing at all because it destroys the
  261.    meaning of OO.
  262.  
  263.  o GAUGE disabled...there should be GAUGE Method imho
  264.  
  265. V43.395
  266.  
  267.  o Added a cludge to avoid a BestModeID crash
  268.  o Added a Volume Gauge...will be configurable in the future
  269.  o ilbm.datatype that handles 24bit...thanx Matthias
  270.  
  271. V43.352
  272.  
  273.  o Fixed a problem with WBPattern(not only this) and some pictures.
  274.    The reason was that BestCModeIDTagList() doesn't always work
  275.    and i had no fallback mode so the returned monitorid was INVALID.
  276.    This caused a lot problems..expecially the HAM/HALFBRIGHT bit test
  277.    on the modeid resulted into a wrong decision because INVALID=-1.
  278.  
  279. V43.340
  280.  
  281.  o DTM_PRINT added. It does nothing for 24Bit bitmaps.
  282.  
  283. V43.338
  284.  
  285.  o DTM_COPY added. It writes 8Bit and 24Bit output.
  286.  
  287. V43.335
  288.  
  289.  o DTM_WRITE added. It writes 8Bit and 24Bit output.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297. Questions&Bugreports
  298. Don't expect fast response.
  299.  
  300. Ralfph Schmidt
  301. laire@popmail.owl.de
  302.  
  303.  
  304.